docs: add simulated GPU scheduling troubleshooting - #788
docs: add simulated GPU scheduling troubleshooting#788Samkeliso-dube00 wants to merge 2 commits into
Conversation
Signed-off-by: Samkeliso <lainne_coatzee@icloud.com>
Signed-off-by: Samkeliso <lainne_coatzee@icloud.com>
hami-robot
Bot
added
the
kind/documentation
✅ Deploy Preview for project-hami ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: Samkeliso-dube00 The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
|
Important Review available on request
Reviews should be triggered manually for repositories with fewer than 10 stars. Select Trigger review above or comment ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
|
Hi @rootsongjc and HAMi maintainers, This PR adds troubleshooting documentation for GPU pod scheduling failures with simulated GPUs. It addresses issue #656 by providing diagnostic steps and recovery procedures for a common user pain point. This is submitted as part of my LFX Mentorship application for the "Expand HAMi GPU-sharing tutorials, labs, and troubleshooting guides" project. Looking forward to your feedback. |
mesutoezdil
left a comment
mesutoezdil
left a comment
There was a problem hiding this comment.
useful guide and the recovery flow matches the registration protocol docs. fixes #656 would close the lfx umbrella issue, use part of. all four checklist boxes are empty and the docs health ci did not run on this pr, please rebase and run lint, format and the full build. the zh follow up note is fine.
|
|
||
| ### Troubleshooting | ||
|
|
||
| If the pod remains `Pending`,verify that Kubernetes advertises the simulated GPU resources: |
There was a problem hiding this comment.
missing space after the comma.
|
|
||
| ::: | ||
|
|
||
| ## GPU Pod Scheduling Failure with Simulated GPUs |
|
Thanks for the feedback, @mesutoezdil. I see PRs #741, #773, #779, #783 |
2 participants
What type of PR is this?
/kind documentation
What this PR does / why we need it:
Adds a troubleshooting guide for GPU pod scheduling failures when using HAMi with simulated/fake GPUs.
When users deploy GPU workloads with simulated GPUs (like GPU Operator's mock devices), pods can remain
Pendingeven though Kubernetes advertises GPU resources. This guide explains the root cause (HAMi requires device information in JSON format) and provides step-by-step recovery procedures.Which issue(s) this PR fixes:
Fixes #656
Checklist:
npm run lintandnpm run format:checkpassnpm run buildsucceeds for bothenandzhgit commit -s)Note: This PR adds troubleshooting content only. Chinese translation can be added in a follow-up PR.